Copyright: (C) 1995 PlotSoft Solutions


Table of Contents

WinGL version 1.54a (c) Copyright PlotSoft Solutions 1995.

Portions of WinGL Help are (c) Copyright Ravitz Software Inc 1990,1995 from the PrintGL shareware package.

WinGL, from PlotSoft Solutions, is a full featured Windows 3.1 interface to the HP-GL file engine PRINTGLW.EXE from Ravitz Software.

General Information:

WinGL/PrintGLW 	The WinGL/PrintGLW Relationship.

Getting Started 	A quick start guide to WinGL.

Table of contents:

AutoPlot	Automatically plot files.

AutoPlot Parameters 	Specify AutoPlot Parameters.

Color Processing 	Specify the use of color.

Configuration Files 	How to save and load WinGL configuration files.

Confirmation 	Configure WinGL confirmations.

Drives / Directories 	Drives / Directories selection.

Magnification	 	Applies magnification to the plot/display.

Matching Files List 	Matching Files List box operation.

Misc Plotter Settings 	Plotter Configuration Settings.

Number of Copies 	Select the number of copies to plot.

Optional Resolution 	Specify non-standard device resoutions.

Pen Configuration 	Allows Pen Color/Width and Shade configuration.

Plot File Mask 	Specify the plot file mask for your HPGL files.

Plot Multipliers	Specify X and Y axis multipliers for the output plot.

Port Delay 	Provides support for slower printers.

Printer Codes 	Specify printer prefix and suffix codes.

Print/Plot Origin 	Specfies the plot position.

Registration 	Information on Licensing WinGL.

Registration Form 	Registration form for Licensing WinGL.

Registration Screen 	Tips on filling in the Licensing information.

Select Plot Page 	Select the page to plot.

Selected Files List 	Selected Files List box operation.

Shareware 	Shareware concept.

Technical Support 	How to obtain technical support for WinGL.

Tiling 	Plot Tiling.

Windows / Margins 	Page Setup.


Select Plot Page

__________________________________________________________

[PrintGLW | Select Page Plot]  Ctrl+E

 In multiple page HP-GL files you can select which page to plot if you only wish to plot one of the pages. If you wish to plot all of the pages in the file select "all".


Plot Multipliers

__________________________________________________________

[PrintGLW | Modify Output | Set Horiz/Vert Multipliers]  Ctrl+M

With this dialog, you can append the true horizontal and vertical resolution of the output device in dots/inch. This overrides the normal output device resolution, but does not affect the structure of PrintGLW's output. This lets you compensate for print size error. For example, a 360x360 dpi printer consistently under indexes so that a 6 inch high box comes out 5.94 inches. Using 360,363.6 (6/5.94*360 = 363.6) removes the error. For print size correction, you also specify a number from 0.5 to 2 which is interpreted as the nominal resolution times this number. For example on a 360 dpi printer, settiing Horizontal to 1.0, and Vertical to 1.01 is the same as 360,363.6.


Printer Codes

__________________________________________________________

[PrintGLW | Modify Output | Set Printer Codes]  Ctrl+X

PrintGLW can handle printing on paper larger than the usual 8.5x11, but this takes some extra work. First you need to increase PrintGL's print window to cover the large paper. This is done with the WinGL [PrintGLW | Windows / Margins] menu selection. The print window plus the margins must fit within the printer's printable area.

Note. The portion of the following examples that you enter into the dialog box cells is in bold face. In addition, the underscore character _ is used to show blank spaces between numbers AND SHOULD NOT BE INCLUDED WHEN ENTERING THE PARAMETER. Place a space where the _ character is.

Next you must make sure that your printer recognizes the larger paper height. For continuous forms paper this is best done by setting skip perforation to off, either by printer switch or with PrintGLW prefix codes. For Canon, Epson, Fujitsu, IBM, and NEC line printers (dot matrix, ink jet, thermal) use a prefix code of 27_79.

For cut sheet paper, on Canon (except BJ native mode), Epson, Fujitsu, IBM, and NEC line printers use a prefix code of 27_67_0_n, where n is the page length in inches. For the PDP ProTracer use a prefix code of 27_67_n, where n is the page length in lines, at six lines per inch.

For some printers you need to increase the right margin. For the Canon BJC in Epson mode use a prefix code of 27_81_114. For the HI V50/100 in printer mode use a prefix code of 27_91_88_2_0_1_255 .

For page printers, legal size paper may be specified with these printer code prefixes: HP-PCL printers use a prefix code of 27_38_108_51_65 ( and a suffix code of 27_38_108_50_65 to reset to letter), Canon LBP use a prefix code of 27_91_51_50_59_59_112 ( and a suffix code of 27_91_51_48_59_59_112 to reset), IBM LaserPrinter use a prefix code of 27_91_70_5_0_3_1_2_1 (and a suffix code of 27_91_70_5_0_3_1_1_1 to reset).

To get a 10x16 print window on 11x17 paper with a Canon, Epson, Fujitsu, IBM, or NEC line printer, select [PrintGLW | Windows / Margins] and set Width, Height, Left Margin and Top Margin to 10, 16, 0, 0.25 respectively and set the prefix code to 27_67_0_17. You will probably need to adjust the Left Margin and Top Margin in [PrintGLW | Windows / Margins] for best centering.

The maximum width of the print window on most narrow carriage printers is 8 - 8/(horizontal dpi). For 300 dpi printers, this is 7.97. At 120 dpi it is 7.93. The maximum width of the print window on most wide carriage printers is 13.6 - 8/(horizontal dpi). At 180 dpi this is 13.55. At 360 dpi it is 13.57. The horizontal margin should be set to 0 to get this width.

At the moment WinGL does not do any checking for the validity of printer codes, however PrintGLW may post an error message if the print codes are invalid.


Magnification

__________________________________________________________

[PrintGLW | Magnification]  Ctrl+A

This option sets the magnification. Checking the "Fit then magnify" box fits the plot to the print window. The default is 0.9 with fit applied, which prints at 90% of the largest size that fits in the print window.


Print/Plot Origin

__________________________________________________________

[PrintGLW | Position | Plot x,y @ plot origin/center]

This option determines the location of the plot in the print window via a point on the plot that is aligned with a point in the print window. You can specify the plot alignment point with x,y in inches from the plot's origin (before PrintGLW applies magnification), or let it default to the plot center. For the print window alignment point, you can default to the center by using "Plot x,y @ plot center" or specify the origin by using "Plot x,y @ plot origin"


Pen Configuration

__________________________________________________________

[PrintGLW | Pen Setup] Ctrl+P

WinGL permits you to configure all 40 pens supported by PrintGLW. Use the mouse to click the up/down arrows to increment the pen number and then again to set the Width, Shade and Color you wish to apply to that pen. Only configure the pens you need, up to the number supported by the selected device.

When processing the pen information, WinGL stops processing at the first pen with width set to "off". For example, if pen #3 has Width set to "off", WinGL performs no further processing beyond pen #2 when creating the command line parameter to be passed to PrintGLW.

The "Default" buttons, reset the Width, Shade and Color of the pens to:

Width	- pen #1 is set to 0.2mm and all others are set to "off"

Shade	- all pens are set to 100%

Color	- all pens are set to black and opaque

By default, colors are overwritten into the print, so they appear opaque. You can switch to translucent colors (or'ed into the print) by checking the "transculent" check box, and then back to opaque by checking the "opaque" checkbox. For PostScript and plotters, the color processing is done by the device, not PrintGLW. PostScript uses opaque colors and plotters use translucent colors.


Windows / Margins

 __________________________________________________________

[PrintGLW | Windows / Margins]  Ctrl+W

This option defines the page layout.

Checking the "Box the window" checkbox boxes the plot at the print window edge using pen 40.

The "From feed" box is checked by default and turns form feeds on. Remove the check to turn form feeds off. These are ignored for display output.

Checking the "Reverse image" checkbox reverses the colors on displays, and output formats for, Canon, HP, and IBM page printers and is otherwise ignored. This gives the equivalent of a photographic negative.

The Width and Height values are the print window width and height in inches. These define the hard clip limits. These values are not checked against the printer's capabilities. If you specify a print window that exceeds the output device limits, the results are unknown. You may need to reset the printer's margins or page length for large plots. The size needed for a given width and height exceeds x and y by 8 dots to allow for line widths.

The Left Margin and Top Margin are the left and top margins, measured from the printer's left margin and current vertical position to the print window. The margins for HP-GL and PostScript are measured from 0,0 (left, bottom). Margins are ignored for display output.

THE PRINT WINDOW PLUS THE MARGINS MUST FIT WITHIN THE PRINTABLE AREA OF THE PRINTER.

To find the largest printable area turn on the box and form feed options and set a window and margins of 7.5,10,0,0.Any plotfile will do - the only concern is the box. Increase the window until you have the largest box that fits on the paper. This is the best that you can do. To improve centering you can reduce the print window and increase the corresponding margin.

The default print window is 7.54x10.14 for printers and 10.14x7.54 for HP-GL and displays, corresponding to HP 7440 A paper. The default margins are printer specific to compensate for paper handling.

The four "Select Set" buttons allow you retain up to four different sets of parameters that can be quickly recalled by clicking the appropriate button.

Listed below are some standard setting for the indicated devices:

To set window equivalent to	Width	Height

---------------------------------------	---------	----------

HP 7440 with A paper	7.54	10.14

HP 7440 with A4 paper	7.54	10.74

HP 7475 with A paper	7.84	10.2

HP 7475 with A4 paper	7.6	10.88

HP 7475 with B paper	10.2	16.38

HP 7475 with A3 paper	10.88	15.90


Tiling

__________________________________________________________

[PrintGLW | Tiling]  Ctrl+I

Tiling lets you specify tiling options that break a large plot into tiles. Each tile is defined by the page layout option (see Windows / Margins). [i] and [j] specify the number of tiles horizontally and vertically. [x] specifies the overlap in inches. Displayed plots are sized based on the tiling, but only the first tile is displayed. Use the cursor keys to scroll the plot.

Horiz [i] Vert[j]   Overlap[x]

------------------------------------------------

 2 	  2   	0.5 	breaks the plot into 4 pages with .5 inch overlap

 1	  1   	0 	is the default and produces no tiling


Number of Copies

__________________________________________________________

[PrintGLW | Number of Copies]  Ctrl+C

This dialog allows you to set the number of copies for each printed page. The default is one. The "Hardware Copies" checkbox specifies to send the codes to have the printer produce multiple copies, which is much faster than having PrintGLW send the data for each page. This only works with page printers.


miscellaneous plotter
Miscellaneous Plotter Settings

__________________________________________________________

[PrintGLW | Misc Plotter Setting]  Ctrl+L

The D/Y checkbox group sets the plotter's D/Y switch to D or Y and the S/E checkbox group set the S/E switch to S or E. Checking the "set to Y" checkbox starts with the plotter off and responds to esc.(, esc.Y, esc.), and esc.Z commands. Checking the "set to D" checkbox starts with the plotter on and ignores these commands. Checking the "set to S" checkbox sets the standard interpretation of IW (clipping window) commands. Checking the "set to E" sets 7550 enhanced interpretation of IW commands, so that they use scaled coordinates.

Checking the "Read ADI" checkbox will turn on PrintGLW's ADI handler.

Checking the "Yes" under read HPGL/2 turns on PrintGL's HP-GL/2 subset interpretation.

Checking the "except pens" under read HPGL/2 turns on PrintGL's HP-GL/2 subset interpretation but causes PrintGLW to ignore HP-GL/2 pen width, color, shading, and transparency control.

Checking the "start on for Y, HPGL/2" under Other Stuff starts with the plotter on if the Y checkbox is set or if the "Yes" or "except pens" checkbox are checked. This is useful for HP-GL/2 that assumes the plotter is already in HP-GL/2 mode rather than HP-RTL mode.

Checking "large polygon buffer fill" increases the polygon fill buffer by 4000 line segments.

Internal DPI sets PrintGLW's internal grid resolution in dots/inch. It is normally1016 and rarely needs to be changed. To fit very large plots into the -32768..32767 coordinate limit, use 508. Setting the resolution to a multiple of the output device resolution times the magnification may yield a small improvement in print quality.

Chord Parameters

Except for the "color to shade on b/w formats" checkbox, these options are not useful with HP-GL (including AutoCAD's) or ADI that draws circles, arcs, and text as line segments rather than using circle, arc, and label commands.

The default, minimum and maximum entries specify the default, minimum, and maximum chord angles for circles and arcs. The HP 7475 defaults to a chord angle of 5 with no minimum. Using chord angles of less than 10 returns little print quality improvement and adds to processing time. The default is: default,minimum,maximum = 10,5,180 respectively. For better emulation use 5,2,180 respectively.

Checking the "use the enhanced font" checkbox will use the enhanced font, which doubles the number of chords on curves in text, improving the curve smoothness. This is only effective on character heights above .5 cm.

When checked, the "color to shade on b/w formats" checkbox converts colors to shade levels for monochrome output formats. Otherwise all colors except white are converted to black.


Confirmations

__________________________________________________________

[WinGL | Confirmations]  Alt+C

WinGL allows you to configure when it will prompt you on certain actions. The default condition is to prompt you for everything, but you will likely find that you can disable many or all of these prompts once you become familiar with the program's operation. To enable a specific confirmation, place a check mark beside the parameter using the mouse or use the up/down arrow keys and the space bar on the keyboard. Clearing the check mark in the same manner will turn off the confirmation.

Below is a description of the action WinGL will take if the confirmation is checked.

Ready to go on multiple plots:

Will prompt you when WinGL is ready to begin the next Print/Display or Edit operation on the files in the Selected Files List . This is useful when you need to load paper in a plotter for example.

Configuration has changed:

Will notify you when the WinGL/PrintGLW parameter configuration has changed when you attempt to quit the program or load another configuration. You can then save your configuration before quiting.

Quiting WinGL:

Will prompt you to confirm you are about to quit the program.

PrintGLW command line is ready:

Will display the PrintGLW command line before actually passing it to PrintGLW.

Deselecting a Selected file:

Will prompt you before removing a selected file from the Selected Files List box.

Overwriting a configuration file:

Will prompt you if you select a configuration file name that already exist when saving your configuration.

Device compression is supported:

Will prompt you when you select an output device that supports data compression.


drives / directories
Drives / Directories List Box

This list box display all the drives and directories available on the system. You use it to select where your HP-GL files are located. You can double click with the mouse to make a selection or you can use the <Tab> key to move the hilite to the list box and then use the up/down arrow keys and the <Enter> key to select.


matching files
Matching Files List Box

This list box shows all the files that match your Plot File Mask in the Drives/Directories List selection. To move these files to the Selected Files List, you can hilite them with the up/down arrow keys and then press <Enter> or you can double click on them with the mouse.


selected list box
Selected Files List Box

This list box displays the HP-GL files that you have selected to print/display or edit. These files are selected by appropriate selections in the Drives/Directories List , the Matching Files List , and the Plot File Mask.

To perform a Print/Display or Edit operation on these files, you can either click the RIGHT mouse button, press the <enter> key on any of the files in the list, or select one of the [File | Print/Display/Edit] menu selections, or any of their hot keys, Alt+P, Alt+D or Alt+E respectively. Performing the right mouse click or pressing the <Enter> key will pop up a small sub-menu allow you to select [Print] / [Display] or [Edit] from that menu.

To remove a file from the Selected Files List, you can press the <delete> key when the file is hilighted or you can double click on the file with the left mouse button.


AutoPlot

__________________________________________________________

[WinGL | AutoPlot]  Alt+A

The AutoPlot function allows you to select files using a Plot File Mask and a drive directory from the Drives/Directories List to be plotted automatically. These files can currently exist in the specified location or they can be copied or generated there at some time in the future.

AutoPlot is primarily aimed at LAN users that wish to share a single output devce such as a laser printer, setup as a LAN printer, although it works very well with local drives and output devices as well.

Here is a recommended procedure for setting up and using AutoPlot.

1) select a file mask in the Plot File Mask that matches the files you wish to plot.

2) select in the Drives/Directories List the drive / directory you wish to use.

3) ensure all other PrintGLW and WinGL parameters are set correctly.

4) ensure you have selected the device and destination you wish to AutoPlot to.

5) engage AutoPlot.

You can engage AutoPlot with the hot key Alt+A, by checking the AutoPlot checkbox or by selecting the menu selection [WinGL | AutoPlot]. When you do so WinGL shows a warning.

PLEASE BE ADVISED !

AUTOPLOT DELETES THE PLOT FILE AFTER IT IS PLOTTED.

Therefore DO NOT place the only copy of an HPGL file you have in the AutoPlot specified directory and engage AutoPlot. A better approach is to set up a dummy directory into which you can copy or generate your HPGL files and specify this directory in step 2 above.

If you select to proceed after the delete file warning, WinGL needs to know whether you wish to be prompted before starting each file. If you have an automatic paper feed device such as a laser printer or roll feed plotter you should select No. If not, select Yes to permit you to set up the output device before WinGL starts each plot.

Now WinGL "freezes" the current set of configuration parameters, including the Plot File Mask as well as the Drives/Directories List , in the AutoPlot routines and will set up a timer in Windows that goes off every 5 seconds. When the timer goes off, if WinGL finds a file in the "frozen" directory matching the "frozen" file mask, that file will be output to PrintGLW and THEN DELETED when PrintGLW completes processing. The timer is suspended while PrintGLW is processing the current file.

AutoPlot operation continues until you disable it with Alt+A, with the menu selection [WinGL | AutoPlot] or by unchecking the AutoPlot checkbox. As long as you leave AutoPlot engaged it will pickup and plot any matching file as it appears in the specified location. AutoPlot waits until the file size shows other than 0 bytes before beginning to plot. If you wish to change the AutoPlot Parameters while AutoPlot is enabled, select [WinGL | AutoPlot Parameters] from the menu or press the hot key Alt+U any where in the main program window.

With AutoPlot engaged you can continue to output files to another device or to the CRT by selecting another output device / destination and selecting a new Plot File Mask, and drive directory from the Drives/Directories List . This permits you to "multitask" WinGL, displaying or printing a list of files "manually" while also printing files in the AutoPlot directory.


Plot File Mask

The Plot File Mask is where you enter a DOS file mask for selecting files to be placed in the Matching Files List . Any files matching the Plot File Mask in the directory you selected in the Drives / Directorieslist box are placed in the Matching Files List.You can use the wildcards ? and * in the Plot File Mask in the same manner you would with any DOS command.

NOTE!. DO NOT enter drive or directory names in the Plot File Mask, only a file mask. Examples of acceptable file masks are:

*.PLT

hp??.*

*.*

The backslash character is not permitted. To specify a particular drive/directory, use the Drives / Directories list box to select the drive/directory first.


WinGL / PrintGL
The WinGL / PrintGLW Relationship

WinGL makes it easy for you to configure and use PrintGLW. All you need to know is where PrintGLW is on your system. By selecting from WinGL's menus and dialog boxes all the parameters supported by PrintGLW can be configured. WinGL then creates a command line for PrintGLW and calls PrintGLW with that command line when you select [Files | Print/Display] to Print or Display your HP-GL files.

WinGL and PrintGL are two entirely separate shareware programs from two different authors.

You should understand that WinGL permits you to generate a PrintGLW command line using a full featured Windows interface. This commanld line is then passed to PrintGLW.EXE when you elect to Print or Display your HP-GL files. Once that has been done and PrintGLW has been invoked with that command line, all the documentation and understanding you have about PrintGLW applies. PrintGLW still does all the work of sending the HP-GL file to your output device. You can view the command line WinGL has constructed by leaving the "PrintGLW command line is ready" checkbox enabled in Confirmations .

It is for this reason that portions of this help file are lifted from PRINTGL.DOC that comes with Ravitz Software's PrintGL package. This information is Copyright by Ravitz Software and is used here with the permission of Ravitz Software.

Also, please understand that continued of use of WinGL with PrintGLW requires you to license BOTH programs if you have not already licensed PrintGLW. WinGL is produced by PlotSoft Solutions and PrintGLW is produced by Ravtiz Software Inc. Please support the shareware concept and register the shareware that you use.

For more information on licensing WinGL, see Registration

PrintGL Licensing:

The following is the licensing information for PrintGL taken from PRINTGL.DOC in the PrintGL shareware package.

PrintGL is copyrighted by Ravitz Software Inc. You may copy PrintGL only for use under this license agreement.

PrintGL is distributed as shareware. You may use PrintGL without charge on a trial basis to determine its suitability for you. If you continue to use it after your evaluation, you MUST purchase a registered copy for 50 (US$). Registration covers use by a single person (on multiple computers) or installation on a single computer (may be used by a group of people). There is no cost to use a later 1.** version after registering any 1.** version.

You may distribute PrintGL as a stand alone product if you keep the entire package together, unchanged, clearly label the disk as shareware, and do not charge more than $10. You may not distribute PrintGL as part of another product or on the same disk with any commercial software.

For more information on licensing PrintGL select [Help | Registration Info | PrintGLW]


Registration
Registering WinGL

WinGL is not free software. You can obtain a single user license for WinGL by filling out the Registration Form and mailing it to the address shown on the form.

You are granted a temporary evaluation license for a duration of 45 calender days in order to determine if the program meets your requirements. During that period you can contact me and I will assist you with problems as time permits. However, I must stress that REGISTERED users (those that have paid the Licensing fee) are my first priority with technical support when required.

WinGL will display a Registration Reminder Screen everytime you start the program and everytime you quit as well. This screen shows you how many days you have remaining in the evaluation period.

After 45 days, if you still have not entered a valid registration code, WinGL will disable it's [File | Print/Display/Edit] menu selections and display the word "EXPIRED" in the lower left status cell.

WinGL represents a considerable amount of work. Please support the shareware you use.

To obtain a valid registration code, fill out the registration form and send it to the address shown below with the appropriate license fee. The license fee is $45.00 in US funds for a single user license. Multiple and site licenses are available as shown on the registration form . Upon receipt of the license fee I will supply you with a registration code to unlock WinGL which will restore full program functionality and disable the reminder screens.

Send the completed Registration Form for WinGL to:

E. Ayliffe

PlotSoft Solutions

RR #4 Shelburne

Ontario Canada

N0B 1S8.

Phone: 519.925.5468

You can contact me as above or in addition:

CompuServe Information Service PPN: 70007,3536

INTERNET: 70007.3536@compuserve.com

For information on registering PrintGLW, select the [Help | Registration Info | PrintGLW] menu selection.


Registration Screen

You can fill in any User Name and Company Name you wish, however I would advise you to fill in legitimate information in these cells so you can indentify your own licensed version of WinGL. Once you enter a valid registration code you CANNOT change the User Name or Company Name so be certain you have everything the way you like it before you press the Ok button.

Enter the registration code supplied to you EXACTLY as it appears. Case is sensitive and all the digits must be entered for the program to accept the code as valid.


Shareware
The Shareware Concept

Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to obtain a license for (register) it. It is as simple as that.

Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group.

Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it.

J. Edward Ayliffe is a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, the ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road Muskegon MI 49442-9427 or send a Compuserve message via easyplex to ASP Ombudsman 70007,3536.

WinGL is a "shareware program" and is provided at no charge to the user for evaluation purposes only. Feel free to share the self extracting file WINGL.ZIP with your friends and colleagues, but please do not give it away altered or as part of another system. The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products. If you find this program useful and find that you are using WinGL and continue to use WinGL, you must fill out the Registration Form and send it along with the appropriate licensing fee to:

            J. Edward Ayliffe.

            RR#4 Shelburne Ontario

            Canada L0N 1S8

The $45 Licensing fee will license one copy for use on any one computer at any one time. Under a single user license you must treat this software just like a book. An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another, just as a book cannot be read by two different persons at the same time. Multiple user and site licenses are available.

After the 45 day evaluation period, the unlicensed version of WinGL will expire if you have not entered a valid code in the Registration Screen , after which it will run expired until you enter a valid code, under the [Help | Registration Info | WinGL] menu selection.


AutoPlot Parameters

__________________________________________________________

[WinGL | AutoPlot Parameters]  Alt+U

This dialog permits you to review all and change some of the AutoPlot parameters WinGL is using. Currently you cannot change the Path, Mask or PrintGLW Command Line. To change these parameter you will have to disable AutoPlot, make the appropriate selections with the Drives / Directories, Matching Files List and the Plot File Mask and then re-enable AutoPlot with the new parameters.

However, you are permitted to change the Prompt before starting each plot parameter and the PrintGLW AutoPlot Runmode. To make changes, simply <Tab> to the desired checkbox and press the <SpaceBar> to toggle the check, or use the mouse and click the left button on the desired setting.

Note: PrintGLW AutoPlot Runmode will not be supported until version 1.56 of PRINTGLW.EXE.

These parameters are saved in your Configuration Files so if you wish to retain them, save your configuration with ALT+S or [File | Save Configruation] after you make the changes.

AutoPlot Parameters is disabled if AutoPlot is disabled. It is only enabled when AutoPlot is enabled.


config
Configuration Files

WinGL permits you to store as many different configurations as you have disk space to save them. Virtually every WinGL and PrintGLW parameter is saved in the configuration files.

To save a configuration file you can select the [Files | Save Configuration], or press the hot key ALT+S.

To load a configuration file you can select the [Files | Load Configuration], or press the hot key ALT+L. When you load a configuration into memory the current configuration is lost, but WinGL will add the filename of the current configuration to the bottom of the [File] menu. A total of 5 past configurations file names are saved in this manner. You can pop back and forth between configurations using the hot key sequence Alt+x where x is a number from 1 - 5 corresponding to a file name as shown in the [File] menu list.

If you load a configuration file with Alt+L or by using the [File | Load Configuration] menu selection, WinGL will prompt you to save the existing configuration if it has changed since it was loaded. However, if you swtich to a configuration file listed in the [File] menu with the Alt+x sequence, you WILL NOT be prompted to save the existing configuration if it has been changed since you last saved it. I implemented it this way to facillitate fast configurations changes, so ensure your configuration has been saved before using the Alt+x hot key to switch to another configuration file.

The default extension for configuration files is WGL, but you can call them whatever you wish. Using descriptive names is recommended to make it easier to remember what the file configures WinGL/PrintGLW for, ie LJ2LPT1.WGL is a good name for a Laser Jet II on LPT1 configuration file.


optional resolution
Optional Output Resolution

__________________________________________________________

[Printer/Plotter | Optional Resolution] Ctrl+O

This dialog permits you to specify a non-default resolution for your output device. Only a select number of device types support optional resolutions and how that resolution is specified is also device dependant.

Resolution can be specified in one of two ways, depending on the device selected.

1) using an i X j modifier or

2) specifying a dots per inch (dpi) modifier.

Following is a list of WinGL/PrintGLW supported devices that allow optional resolutions, the type of resolution supported by those devices and the permitted value range.

Device	Resolution type	Permitted range

HP-GL/2 printers	dpi	75-1200

HP-GL/2 raster plotters	dpi	75-1200

HP-GL/2 pen plotters	dpi	75-1016

HP-RTL raster plotters	dpi	75-600

HP-GL 	enhanced	dpi	75-1016

PostScript                	dpi	10-1016

append EPS preview bit map 	dpi or i X j	10-600

ZSoft PCX              	dpi or i X j	10-600

The dialog box contains scroll bars to change the i and j values or you can edit the value directly by clicking in the edit window and typing in a number. You have to check the Enable Optional Resolution box to turn on the edit cells and the scroll bars.

If you check the dpi checkbox, only the i cell and scroll bar will be enabled because dpi specification only requires a single parameter. You have to decide what resolution and resolution type you wish to use. For dpi only devices, the j parameter will be ignored even if you neglect to check the dpi checkbox. For devices that support both dpi and i X j, you MUST check the dpi box to use dpi resolution, otherwise i X j will be used on these devices, assuming Enable Optional Resolution is checked of course.


Color Processing

__________________________________________________________

[Print/Plotter | Color Processing]  Ctrl+G

Some output devices permit you to suppress their color processing capability. This dialog box permits you to specify whether or not to use color processing and, if you enable color processing, whether or not to enable 4 plane color processing.

This is obviously only useful on output devices supporting color and PrintGLW will ignore the request for color on devices that do not support color processing.


Registration Form

____________________________________

WinGL Version 1.54a.

Copyright (c) 1995 by E. Ayliffe/PlotSoft Solutions.

All Rights Reserved.

____________________________________

Licensing Information 	(please print or type)

Company Name __________________________________________

User Contact ____________________________________________

Postal Address ____________________________________________

Country _______________________   Phone Number _(____)________

Postal Code ___________________

Electronic Mail Address ___________________

If you supply an EMail address I will send you the registration code that way, as well as by return post card.

____________________________________

WinGL License Fee Structure

Please fill in as appropriate

Single user license (upto 5 licenses) 	$45 per license  _______ 	X $45 = _______

6-10 user licenses 	$35 per license  _______	X $35 = _______

11-20 user licenses 	$30 per license  _______	X $30 = _______

unlimited users site license 	$650 per site	 _______	X $650= _______

Please remit the license fee in the form of a bank money order, postal money order, or certified cheque payable in US dollars and drawn on a US, Canadian, English or Swiss bank, or post office to:

E. Ayliffe

RR #4 Shelburne

Ontario Canada

L0N 1S8.

519.925.5468


technical support
Technical Support for WinGL

If you are having problems getting WinGL to operate correctly you can contact me in any of the ways shown below. Upon payment of the licensing fee, you are entitled to unlimited EMail, postal mail or telephone technical support for the product for a period of 6 months after receipt of the licensing fee. However, if you are overseas (not in North America) PLEASE try to find a way to contact me at one of the Electronic Mail addresses as this is inexpensive, timely and detailed.

Unregistered users may obtain technical support, but I am under no obligation to provide support to unregistered users. I CANNOT guarantee I will return overseas phone calls for unregistered inquiries.

Unregistered support will be provide on a time available basis only. Licensed users are my first priority for technical support.

You can reach me in any of the ways shown below. You will get the fastest response by contacting me at one of the electronic mail addresses. If at all possible, that is the best way to obtain technical support.

J. Edward Ayliffe

RR #4 Shelburne

Ontario Canada

L0N 1S8.

Voice: 519.925.5468 (after 18:00 ET)

Compuserve: 70007,3536

INTERNET : 70007.3536@compuserve.com


printer port delay
Port Delay

This dialog permits you to slow the function of the parallel port when using [Printer/Plotter | Select Plot Destination | Direct Parallel Port, Delay] for compatibility with older printers. You can use the scroller arrows to increase or decrease the value or click on the edit window and enter the value you wish to use.

The acceptable range of values is 001 to 999.


Getting Started

If you're reading this then I'll assume you have the program up and running. The first thing you need to know is where PRINTGLW.EXE is on your system. If you don't know, WinGL will let you browse around for it. If you don't have PRINTGLW.EXE you can obtain it from:

Ravitz Software Inc.

P.O. Box 25068

Lexington, KY 40524-5068 USA

Compuserve Cary Ravitz [70431,32]

BBS/FAX 606-268-0577

1) To locate PRINTGLW.EXE on your system using WinGL, select [Files | Specify PrintGLW Location]. This means select the Files menu with the mouse and then the first selection in that menu Specify PrintGLW Location. You can also just press the hot key Alt+G anywhere in WinGL's main window.

This will open a pretty standard Windows file browser with the file mask specified as PRINTGLW.* Locate PRINTGLW.EXE on your system with this browse dialog and double click the filename PRINTGLW.EXE, when it shows up in the Files list box on the left.

NOTE: WinGL DOES NOT support the DOS version of PRINTGL, PRINTGLD.EXE.

2) Now you need to know where the HP-GL files are located on your system and a file mask that matches those you wish to print or display. Enter the file mask in the Plot File Mask cell. Typically this will be something like *.PLT, but it can be any valid DOS file mask. The wild card characters * and ? are permitted but drive/directory names ARE NOT permitted in the Plot File Mask.

3) In the Drives / Directorieslistbox, select the drive/directory that contains your HP-GL files. As you select various directories, files matching your file mask will be filtered into the Matching Files List. Once you have all or at least some of the files you are interested in processing through PRINTGLW, you transfer them to the Selected Files List by double clicking on them in the matching files list.

4) Once you have one or more files in the selected files list, you can click the RIGHT mouse button which will pop up a small sub menu allowing you to choose, Print Files, Display Files or Edit Files. I would suggest you select Display Files first to get a feel for how all this works. Alternately you can select the [Files | Display Plot File] menu, but the right mouse button is handier.

WinGL will use the default Windows display if you don't tell it to use anything else and this is the safest way to proceed. Later you can select your spiffy hi res display driver.

When you click [Display Files], WinGL will display the PRINTGLW command line it has composed. Click the Ok button and WinGL will then indicate that it is "Ready to go". Click Ok again, and with any luck at all, WinGL will call PRINTGLW and your plot will be displayed. The previous two prompts, as well as others in the program, can be disabled using the [WinGL | Confirmation ] menu selection.

If you failed to specify the location of PRINTGLW, WinGL will prompt you for the location before it attempts to display the files.

5) If you wish to print/plot a file you need to go into the [Printer/Plotter | Print /Plot Device] menu and select your output device. The devices are generally arranged in this menu by manufacturer. Negotiate your way through the menu until you find your device and select it.

6) Now you need to specify what port your device is on and the specifics of how to send the data. The options here are very numerous, and if you are not certain I can only refer you to PRINTGL.DOC in the Ravitz Software package for the correct method of communicating with your specific device.

I hope that will get you started. You can use the [PrintGLW] menu to specify any of the customisations and options PRINTGLW allows. I suggest you browse through the help files when necessary.


Command Line
PrintGLW CommandLine

This dialog permits you to view the command line that WinGL is going to use to call PrintGLW based on your current PrintGLW menu configuration. You can click on the command line at any point and then use the cursor keys to scroll it left or right if it is too long to fit in the cell, in order to view all of it. You cannot edit the command line, only view it.

Click OK to proceed. Click Cancel to stop the Print/Display process.

If you don't wish to see this prompt anymore, check the "don't show me this anymore" checkbox. This is the same a selecting [WinGL | Confirmation] and unchecking PrintGLW command line is ready.


Ready to go

WinGL will display this prompt when it is ready to call PrintGLW to print or display an HPGL file.

Click Ok to proceed, click Cancel to stop the print/display.

If you don't wish to see this prompt anymore, check the "don't ask me anymore" checkbox. This is the same a selecting [WinGL | Confirmation] and unchecking Ready to go on multiple plots.


AutoPlot Ready to go

WinGL will display this prompt when it is ready to call PrintGLW to AutoPlot an HPGL file.

Click Ok to proceed, click Cancel to stop AutoPlot.

If you don't wish to see this prompt anymore, check the "don't ask me anymore" checkbox. This is the same a selecting [WinGL | AutoPlot Parameters] or Alt+U and unchecking Prompt before starting each plot


SVGA Mode
SVGA Display Mode

You should enter a display mode number when using SVGA 800X600 display mode. Display configurations are not standardized beyond VGA (640X480) so you need to enter the mode your SVGA card operates in. See you display card manual or computer manual for the correct mode number.

The number will be a hexadecimal number and must be preceded with a $ character. Click Ok enter the mode number, of Cancel to ignore the entry.